<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content=
    "application/xhtml+xml; charset=iso-8859-1" />
    <title>
      rxvt-unicode-9.22
    </title>
    <link rel="stylesheet" type="text/css" href="../stylesheets/lfs.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" />
    <link rel="stylesheet" href="../stylesheets/lfs-print.css" type=
    "text/css" media="print" />
  </head>
  <body class="blfs" id="blfs-2020-04-02">
    <div class="navheader">
      <h4>
        Beyond Linux<sup>�</sup> From Scratch <span class="phrase">(System
        V</span> Edition) - Version 2020-04-02
      </h4>
      <h3>
        Chapter&nbsp;41.&nbsp;Other X-based Programs
      </h3>
      <ul>
        <li class="prev">
          <a accesskey="p" href="rox-filer.html" title=
          "Rox-Filer-2.11">Prev</a>
          <p>
            Rox-Filer-2.11
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="thunderbird.html" title=
          "Thunderbird-68.6.0">Next</a>
          <p>
            Thunderbird-68.6.0
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="other.html" title=
          "Chapter&nbsp;41.&nbsp;Other X-based Programs">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 2020-04-02">
          Home</a>
        </li>
      </ul>
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <h1 class="sect1">
        <a id="rxvt-unicode" name="rxvt-unicode"></a>rxvt-unicode-9.22
      </h1>
      <div class="package" lang="en" xml:lang="en">
        <h2 class="sect2">
          Introduction to rxvt-unicode
        </h2>
        <p>
          <span class="application">rxvt-unicode</span> is a clone of the
          terminal emulator <span class="application">rxvt</span>, an X
          Window System terminal emulator which includes support for XFT and
          Unicode.
        </p>
        <p>
          This package is known to build and work properly using an LFS-9.1
          platform.
        </p>
        <h3>
          Package Information
        </h3>
        <div class="itemizedlist">
          <ul class="compact">
            <li class="listitem">
              <p>
                Download (HTTP): <a class="ulink" href=
                "http://dist.schmorp.de/rxvt-unicode/Attic/rxvt-unicode-9.22.tar.bz2">
                http://dist.schmorp.de/rxvt-unicode/Attic/rxvt-unicode-9.22.tar.bz2</a>
              </p>
            </li>
            <li class="listitem">
              <p>
                Download MD5 sum: 93782dec27494eb079467dacf6e48185
              </p>
            </li>
            <li class="listitem">
              <p>
                Download size: 910 KB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated disk space required: 23 MB (plus 9 MB if gdk-pixbuf
                is present)
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated build time: 0.2 SBU
              </p>
            </li>
          </ul>
        </div>
        <h3>
          rxvt-unicode Dependencies
        </h3>
        <h4>
          Required
        </h4>
        <p class="required">
          <a class="xref" href="../x/installing.html" title=
          "Chapter&nbsp;24.&nbsp;X Window System Environment">X Window
          System</a>
        </p>
        <h4>
          Optional
        </h4>
        <p class="optional">
          <a class="xref" href="../x/gdk-pixbuf.html" title=
          "gdk-pixbuf-2.40.0">gdk-pixbuf-2.40.0</a> (for background images)
          and <a class="xref" href="../x/startup-notification.html" title=
          "startup-notification-0.12">startup-notification-0.12</a>
        </p>
        <p class="usernotes">
          User Notes: <a class="ulink" href=
          "http://wiki.linuxfromscratch.org/blfs/wiki/rxvt-unicode">http://wiki.linuxfromscratch.org/blfs/wiki/rxvt-unicode</a>
        </p>
      </div>
      <div class="installation" lang="en" xml:lang="en">
        <h2 class="sect2">
          Installation of rxvt-unicode
        </h2>
        <p>
          Install <span class="application">rxvt-unicode</span> by running
          the following commands:
        </p>
        <pre class="userinput">
<kbd class="command">./configure --prefix=/usr --enable-everything &amp;&amp;
make</kbd>
</pre>
        <p>
          This package does not come with a test suite.
        </p>
        <p>
          Now, as the <code class="systemitem">root</code> user:
        </p>
        <pre class="root">
<kbd class="command">make install</kbd>
</pre>
      </div>
      <div class="commands" lang="en" xml:lang="en">
        <h2 class="sect2">
          Command Explanations
        </h2>
        <p>
          <em class="parameter"><code>--enable-everything</code></em>: Add
          support for all non-multichoice options. Details about the
          different options can be found in the file <code class=
          "filename">README.configure</code>.
        </p>
        <p>
          <code class="option">--disable-xft</code>: Remove support for Xft
          fonts.
        </p>
        <p>
          <code class="option">--disable-perl</code>: Disable the embedded
          <span class="application">Perl</span> interpreter.
        </p>
        <p>
          <code class="option">--disable-afterimage</code>: Remove support
          for libAfterImage.
        </p>
      </div>
      <div class="configuration" lang="en" xml:lang="en">
        <h2 class="sect2">
          Configuring rxvt-unicode
        </h2>
        <p>
          The <span class="application">rxvt-unicode</span> terminal emulator
          uses the resource class <code class="classname">URxvt</code> and
          the resource name <code class="classname">urxvt</code>. You can add
          X resource definitions to a user's <code class=
          "filename">~/.Xresources</code> or <code class=
          "filename">~/.Xdefaults</code> files or to the system-wide
          <code class="filename">/etc/X11/app-defaults/URxvt</code> file. The
          following example will load the <code class=
          "classname">matcher</code> <span class="application">Perl</span>
          extension (assuming <span class="application">Perl</span> support
          wasn't disabled), which enables a left button click to open an
          underlined URL in the specified browser, sets a background and
          foreground color and loads an Xft font (as the <code class=
          "systemitem">root</code> user):
        </p>
        <pre class="root">
<kbd class="command">cat &gt;&gt; /etc/X11/app-defaults/URxvt &lt;&lt; "EOF"
<code class=
"literal">! Use the specified colour as the windows background colour [default white]
URxvt*background: black

! Use the specified colour as the windows foreground colour [default black]
URxvt*foreground: yellow

! Select the fonts to be used. This is a comma separated list of font names
URxvt*font: xft:Monospace:pixelsize=18

! Comma-separated list(s) of perl extension scripts (default: "default")
URxvt*perl-ext: matcher

! Specifies the program to be started with a URL argument. Used by
URxvt*url-launcher: firefox

! When clicked with the mouse button specified in the "matcher.button" resource
! (default 2, or middle), the program specified in the "matcher.launcher"
! resource (default, the "url-launcher" resource, "sensible-browser") will be
! started with the matched text as first argument.
! Below, default modified to mouse left button.
URxvt*matcher.button:     1</code>
EOF</kbd>
</pre>
        <p>
          In order to view the defined X resources, issue:
        </p>
        <pre class="userinput">
<kbd class="command">xrdb -query</kbd>
</pre>
        <p>
          In order to add the modifications of the new user configuration
          file, keeping previously X configurations (of course, unless you
          are changing any on previously define), issue:
        </p>
        <pre class="userinput">
<kbd class="command">xrdb -merge ~/.Xresources</kbd>
</pre>
        <p>
          The <span class="application">rxvt-unicode</span> application can
          also run in a daemon mode, which makes it possible to open multiple
          terminal windows within the same process. The <span class=
          "command"><strong>urxvtc</strong></span> client then connects to
          the <span class="command"><strong>urxvtd</strong></span> daemon and
          requests a new terminal window. Use this option with caution. If
          the daemon crashes, all the running processes in the terminal
          windows are terminated.
        </p>
        <p>
          You can start the <span class=
          "command"><strong>urxvtd</strong></span> daemon in the system or
          personal startup <span class="command"><strong>X</strong></span>
          session script (e.g., <code class="filename">~/.xinitrc</code>) by
          adding the following lines near the top of the script:
        </p>
        <pre class="userinput">
<kbd class="command"><code class="literal"># Start the urxvtd daemon
urxvtd -q -f -o &amp;</code></kbd>
</pre>
        <p>
          For more information, examine the <span class=
          "command"><strong>urxvt</strong></span>, <span class=
          "command"><strong>urxvtd</strong></span>, <span class=
          "command"><strong>urxvtc</strong></span>, and <code class=
          "filename">urxvtperl</code> man pages.
        </p>
        <p>
          If you use a Desktop Environment, a menu entry can be included,
          issuing, as the <code class="systemitem">root</code> user:
        </p>
        <pre class="root">
<kbd class=
"command">cat &gt; /usr/share/applications/urxvt.desktop &lt;&lt; "EOF" &amp;&amp;
<code class="literal">[Desktop Entry]
Encoding=UTF-8
Name=Rxvt-Unicode Terminal
Comment=Use the command line
GenericName=Terminal
Exec=urxvt
Terminal=false
Type=Application
Icon=utilities-terminal
Categories=GTK;Utility;TerminalEmulator;
#StartupNotify=true
Keywords=console;command line;execute;</code>
EOF

update-desktop-database -q</kbd>
</pre>
        <p>
          For that, you need <a class="xref" href=
          "../general/desktop-file-utils.html" title=
          "desktop-file-utils-0.24">desktop-file-utils-0.24</a> and at least
          one of <a class="xref" href="../x/gnome-icon-theme.html" title=
          "gnome-icon-theme-3.12.0">gnome-icon-theme-3.12.0</a>, <a class=
          "xref" href="../x/oxygen-icons5.html" title=
          "oxygen-icons5-5.67.0">oxygen-icons5-5.67.0</a> and <a class="xref"
          href="../x/lxde-icon-theme.html" title=
          "lxde-icon-theme-0.5.1">lxde-icon-theme-0.5.1</a>. Uncomment the
          line with <span class="quote">&ldquo;<span class=
          "quote">StartupNotify=true</span>&rdquo;</span> if <a class="xref"
          href="../x/startup-notification.html" title=
          "startup-notification-0.12">startup-notification-0.12</a> is
          installed.
        </p>
      </div>
      <div class="content" lang="en" xml:lang="en">
        <h2 class="sect2">
          Contents
        </h2>
        <div class="segmentedlist">
          <div class="seglistitem">
            <div class="seg">
              <strong class="segtitle">Installed Programs:</strong>
              <span class="segbody">urxvt, urxvtd, and urxvtc</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Libraries:</strong>
              <span class="segbody">Many <span class=
              "application">Perl</span> extensions located under <code class=
              "filename">/usr/lib/urxvt/perl</code></span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Directory:</strong>
              <span class="segbody">/usr/lib/urxvt</span>
            </div>
          </div>
        </div>
        <div class="variablelist">
          <h3>
            Short Descriptions
          </h3>
          <table border="0" class="variablelist">
            <colgroup>
              <col align="left" valign="top" />
              <col />
            </colgroup>
            <tbody>
              <tr>
                <td>
                  <p>
                    <a id="urxvt-bin" name="urxvt-bin"></a><span class=
                    "term"><span class=
                    "command"><strong>urxvt</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a terminal emulator for the X Window System.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="urxvtd" name="urxvtd"></a><span class=
                    "term"><span class=
                    "command"><strong>urxvtd</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is the <span class=
                    "command"><strong>urxvt</strong></span> terminal daemon.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="urxvtc" name="urxvtc"></a><span class=
                    "term"><span class=
                    "command"><strong>urxvtc</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    controls the <span class=
                    "command"><strong>urxvtd</strong></span> daemon.
                  </p>
                </td>
              </tr>
            </tbody>
          </table>
        </div>
      </div>
      <p class="updated">
        Last updated on 2020-03-19 00:57:38 -0500
      </p>
    </div>
    <div class="navfooter">
      <ul>
        <li class="prev">
          <a accesskey="p" href="rox-filer.html" title=
          "Rox-Filer-2.11">Prev</a>
          <p>
            Rox-Filer-2.11
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="thunderbird.html" title=
          "Thunderbird-68.6.0">Next</a>
          <p>
            Thunderbird-68.6.0
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="other.html" title=
          "Chapter&nbsp;41.&nbsp;Other X-based Programs">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 2020-04-02">
          Home</a>
        </li>
      </ul>
    </div>
  </body>
</html>
